﻿using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace System.Collections.Generic
{
    /// <summary>
    /// 集合扩展
    /// </summary>
    public static partial class ICollectionExtension
    {
        /// <summary>
        /// 将指定集合的元素添加到 System.Collections.Generic.ICollection&lt;T&gt;的末尾。
        /// </summary>
        /// <typeparam name="T">Generic type parameter.</typeparam>
        /// <param name="this"></param>
        /// <param name="collection">一个集合，其元素应被添加到 System.Collections.Generic.ICollection&lt;T&gt;的末尾。 集合自身不能为 null，但它可以包含为null 的元素（如果类型 T 为引用类型）。</param>
        /// <returns>返回this</returns>
        public static ICollection<T> AddRange<T>(this ICollection<T> @this, params T[] collection)
        {
            foreach (T value in collection)
            {
                @this.Add(value);
            }
            return @this;
        }
        /// <summary>
        /// 将指定集合的元素添加到 System.Collections.Generic.ICollection&lt;T&gt;的末尾。
        /// </summary>
        /// <typeparam name="T">Generic type parameter</typeparam>
        /// <param name="this"></param>
        /// <param name="collection">一个集合，其元素应被添加到 System.Collections.Generic.ICollection&lt;T&gt;的末尾。 集合自身不能为 null，但它可以包含为null 的元素（如果类型 T 为引用类型）。</param>
        /// <returns>返回this</returns>
        public static ICollection<T> AddRange<T>(this ICollection<T> @this, IEnumerable<T> collection)
        {
            foreach (T value in collection)
            {
                @this.Add(value);
            }
            return @this;
        }
        /// <summary>
        /// 从System.Collections.Generic.ICollection&lt;T&gt;中移除包含在collection集合的所有对象的第一个匹配项。
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="this"></param>
        /// <param name="collection"></param>
        public static void RemoveRange<T>(this ICollection<T> @this, params T[] collection)
        {
            foreach (var value in collection)
            {
                @this.Remove(value);
            }
        }
        /// <summary>
        /// 从System.Collections.Generic.ICollection&lt;T&gt;中移除包含在collection集合的所有对象的第一个匹配项。
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="this"></param>
        /// <param name="values"></param>
        public static void RemoveRange<T>(this ICollection<T> @this, IEnumerable<T> values)
        {
            foreach (var value in values)
            {
                @this.Remove(value);
            }
        }
    }
}
